Load contact
Purpose of this building block
Load dedicated contacts from your GMail address book, the address book of the user running your app or any other user that has granted access to their contacts.
You can either manually select a single or multiple contacts or load a contact by a given query or ID.
If you have enabled user input you can also let the user of your app pick the contacts to be loaded.
If this block is the first building block in your flow and you have configured this block to load a single contact, you then can run a batch job. In a batch job your flow will be executed multiple times loading one contact each from your batch job.
Possible use cases
- Generate and send personalized emails or PDF documents to contacts from your Google address book
- Use the contact data in your mails and documents
- Print multiple address labels per page by loading multiple contacts
Configuration
Click on the bold text in the title of the building block to open the configuration dialog.
When dragging this block into the flow you can either select an existing contact from your GMail address book or you can create a new one.
Click on the bold name(s) of the selected contact(s) to change the selected contact(s).
On the left you can find the input variables of this building block: Use the query input variable to replace the selected contact at run-time with a contact that matches your provided query string.
Further information
When printing address labels you'll have to load multiple contacts and use the repeat block to split them up in chunks matching the number of labels you want to print per page.
If you for example want to print 8 address labels per page, select at least 8 contacts to be able to test your template.
Useful combinations
Welcome email to new customers
With the Load contact building block newly added Google contacts are loaded. Using the to HTML building block personalized sign-up offers are created by filling the loaded contact information into a html template. The execution happens in a batch jobs and performs all activities for every loaded contact.
The offers are sent to each user's email address.
To better identify users as a new users in Google contacts the contact can (optionally) be added to a dedicated "New Customer" group using the Add to group building block.
Copy the Mail Merge To Google Contacts app to see this building block in action
Imprint with relevant contacts
The imprint of your web page should list relevant contacts of your company. In order to easily load the most current information you may just load the contact information of the relevant people from your Google contacts.
Using the Load contact building block a single contact with its information is loaded. The available information is then used to generate an imprint html based on a imprint template. You can use the html information on your web-page, in this example the html page is displayed after the execution of the Ultradox flow is stopped.
Send an email with directions from customer to your business location
For your business it may be helpful to provide customers with directions to your location. Many web pages show a businesses location on a Google map but individual customer will need to come up with the directions from their individual location themselves.
This example shows how a customer may enter her/his starting location in a Google from. Once submitted the business address is located from a Google Contact. Of course also for the customer an individual contact can be created allowing you to further process the customer information.
Having access the starting location (customer) and target location (your business) use the Get directions building block to compile the directions. Process the direction information in a html file with can be shown on your web page or emailed to the requesting user.
Copy the Directions To Your Business app to see this building block in action
Questions and Feedback
If you have any comments on this guide, feel free to add them right to the Google document that we are using to create this site.
If you are not yet member of the Ultradox community on Google+, please join now to get updates from our end or to provide feedback, bug reports or discuss with other users.
Last Updated: